Scripting > CxHmiFms > CxFmsHistoryGridCtrl Object > CxFmsHistoryGridCtrl Properties

CxFmsHistoryGridCtrl Properties

The CxFmsHistoryGridCtrl object contains the following properties.

General Properties

Browse by letter:     A     B     C     D     E     F     I     M     P     R     S     U

Property SubType Read Only Description

Appearance

Integer

No

Returns/sets the appearance of the object boundary. Possible values for this property are as follows.

  • 0 – Flat.
  • 1 – 3D

Default value is 0 - Flat

BeginDate

String

No

Returns/sets the starting date of the FMS History Grid.

This string can be in one of the following forms.

  • Absolute date, for example, 1/31/2019
  • Relative date, for example, T (today), T-14 (14 days prior to today), or T+1 (one day following today)

Note: This property is only used if the UseSessionOptions property is set to 0 - No.

Note: Because Session options are universal to all FMS controls, this property can only be set via script during runtime, and the value is not saved to the control.

Default value is T-7

BorderStyle

Integer

No

Returns/sets the border style. Possible values for this property are as follows.

  • 0 - None
  • 1 - Fixed single border

Default value is 0 - None

ChooserFilterString

String

No

Returns/sets the filter to be used when retrieving Nodes.  Wildcard values * (multiple character) and ? (single character) are supported. Wildcards can be used in any part of the string to specify that any character or set of characters is allowed in its place.

Example

A filter string of “*Test*” will retrieve all Nodes with the word “Test” somewhere in the string, such as “TestDevice” or “MyTestDevice” or “Device001Test”.

Default value is * (multiple character wildcard)

ChooserFilterType

Integer

No

Returns/sets the Node property that will be filtered by the string specified in the ChooserFilterString property. Possible values for this property are as follows.

  • 0 – Name
  • 1 – Description
  • 2 – ID

Default value is 0 - Name

ChooserGroupSelection

String

No

Returns/sets the group currently selected in the Node chooser’s Group combo box.

ChooserNodeCategorySelection

Integer

No

Returns/sets the Node category currently selected in the Node chooser’s Node category combo box. Possible values for this property are as follows.

  • 1 – Node2_Category_Device
  • 8 – Node_Category_Gas_Devices
  • 9 – Node2_Category_Liquid_Device
  • 3 – Node_Category_Stations

Default value is 8 - Node_Category_Gas_Devices

ChooserNodeCategoryVisible

Boolean

No

Returns/sets whether or not the Node chooser’s Node category combo box is visible. Possible values for this property are as follows.

  • 0 - No
  • 1 - Yes

Default value is 1 - Yes

ChooserPrimarySortColumn

Integer

No

Returns/sets the primary sort column of the Node chooser’s Node list.

Possible values for this property are as follows.

  • 0 - Type ascending
  • 2 - Name ascending
  • 3 - Description ascending
  • 4 - Type descending
  • 5 - Name descending
  • 6 - Description descending

Default value is 2 - Name ascending

ChooserSiteServiceSelection

String

No

Returns/sets the Site.Service currently selected in the Node chooser’s FMS service combo box.

ChooserSiteServiceVisible

Boolean

No

Returns/sets whether or not the Node chooser’s FMS service combo box is visible. Possible values for this property are as follows.

  • 0 - No
  • 1 - Yes

Default value is 1 - Yes

CmdDefinitionXml

String

No

Returns/sets the XML specifying the custom FMS commands configured for the control.  Another way to configure this property is to use the control’s property page.

ColorAcceptability

Boolean

No

When a ColorGrid option other than "0 - None" is selected, returns/sets whether or not records with a % acceptability below the specified limit will be shown in red to indicate bad data.

Possible values for this property are as follows.

  • 0 - No
  • 1 - Yes

Default value is 1 - Yes

ColorAcceptabilityLimit Integer No

When ColorAcceptability value is set to 1 - Yes, returns/sets the % acceptability limit that is used to determine if the data is bad.

Default value is 90

ColorExceptions

Boolean

No

When a ColorGrid option other than "0 - None" is selected, returns/sets whether or not records with exceptions will be shown in red to indicate bad data.

Possible values for this property are as follows.

  • 0 - No
  • 1 - Yes

Default value is 1 - Yes

ColorGrid Integer No

Returns/sets the color option used by the History Grid control.

Possible values for this property are as follows.

  • 0 - None
  • 1 - Row background
  • 2 - Row text
  • 3 - Date/Time background
  • 4 - Date/Time text

Default value is 1 - Row background

ColumnsXml

String

No

Returns/sets the XML specifying the columns that will be displayed in the FMS History Grid.   

Another way to configure this property is to use the control-specific property page in the CygNet FMS Control Properties dialog box, on the Grid page. See CygNet FMS History Grid Control for more information.

DateFormat

Integer

No

Returns/sets the format of the dates shown in the FMS History Grid. Possible values for this property are as follows.

  • 0 – Device_Time
  • 1 – Contract_Time
  • 2 – Local_Time

Note: This property is only used if the UseSessionOptions property is set to 0 - No.

Note: Because Session options are universal to all FMS controls, this property can only be set via script during runtime, and the value is not saved to the control.

Default value is 0 - Device_Time

DecimalPrecision

Integer

No

Returns/sets the number of decimal places that will be shown in the values displayed by the FMS History Grid.

Acceptable values include 0 - 10 decimal places.

Default value is 7

EndDate

String

No

Returns/sets the ending date of the FMS History Grid. This string can either be in the form of an Absolute date, for example, 1/31/2019, or a Relative date, for example, T (today), T-14 (14 days prior to today), or T+1 (one day following today).

Note: This property is only used if the UseSessionOptions property is set to 0 - No.

Note: Because Session options are universal to all FMS controls, this property can only be set via script during runtime, and the value is not saved to the control.

Default value is T

Font

StdFont

No

Returns/sets the font used by the FMS History Grid control.

Default value is MS Shell Dlg.

IsEditing

Boolean

Yes

Returns whether or not the user is currently editing data in the FMS History Grid control.

MaxDataQuality

Integer

Yes

Returns/sets the maximum data quality percentage to be displayed in the FMS History Grid. Possible values for this property are integers from 1-100.

Default value is 100 %

MeterStationView

Integer

No

Returns/sets whether Station Meters will be displayed in the FMS History Grid as Stations or Devices. Possible values for this property are as follows.

  • 8 – Gas_Devices_Mode
  • 3 – Stations_Mode

Default value is 8 - Gas_Devices_Mode

PITDateTime

String

No

Returns/sets the Point in Time date and time of the FMS History Grid control. 

This string can be in one of the following forms.

  • Absolute Date/Time (for example, 1/31/2019 7:10:14 AM)
  • Relative Date/Time (for example, y-1 m-2 d=15 H=5 M=30 S=0)
  • Relative Day, which is an offset from the current day T (for example, T-10)

Default value is T, date and time today.

See Using the Home Menu for more information about PIT mode.

Note: This property is only used if the UsePIT property is set to 1 - Yes.

RecordOrder Integer No

Returns/sets the order in which records will be displayed in the FMS History Grid. Possible values for this property are as follows.

  • 0 - Oldest _First
  • 1 - Newest_First

Default value is 0 - Oldest_First

RecordSpan

Integer

No

Return/sets the span of each record displayed in the FMS History Grid. Possible values for this property are as follows.

  • 60 – Hourly
  • 1440 – Daily
  • 9999 – Native

SessionBeginDate

String

No

Returns/sets the Session starting date for the time window displayed in the control.  This string can either be in the form of an Absolute date, for example, 1/31/2019, or a Relative date, for example, T (today), T-14 (14 days prior to today), or T+1 (one day following today).

Note: This property is only used if the UseSessionOptions property is set to 1 - Yes.

Note: Because Session options are universal to all FMS controls, this property can only be set via script during runtime, and the value is not saved to the control.

SessionDateFormat

Integer

No

Returns/sets the Session date/time format for the time window displayed in the control. Possible values for this property are as follows.

  • 0 – Device_Time
  • 1 – Contract_Time
  • 2 – Local_Time

Note: This property is only used if the UseSessionOptions property is set to 1 - Yes.

Note: Because Session options are universal to all FMS controls, this property can only be set via script during runtime, and the value is not saved to the control.

SessionEndDate

String

No

Returns/sets the Session ending date for the time window displayed in the control. This string can either be in the form of an Absolute date, for example, 1/31/2019, or a Relative date, for example, T (today), T-14 (14 days prior to today), or T+1 (one day following today).

Note: This property is only used if the UseSessionOptions property is set to 1 - Yes.

Note: Because Session options are universal to all FMS controls, this property can only be set via script during runtime, and the value is not saved to the control.

SessionNodeTag

String

No

Returns/sets the Session Node tag, which specifies the active Node in the FMS Configuration control.  This tag must be in the form SITE.SERVICE|ID (for example, TEST.FMS|2540).

Note: This property is only used if the UseSessionOptions property is set to 1 - Yes.

Note: Because Session options are universal to all FMS controls, this property can only be set via script during runtime, and the value is not saved to the control.

ShowChooserPane

Boolean

No

Returns/sets whether or not the Chooser pane will be displayed in the control.

Possible values for this property are as follows.

  • 0 - No
  • 1 - Yes

Default value is 1 - Yes

ShowOptionsPane

Boolean

No

Returns/sets whether or not the Options pane will be displayed in the control.

Possible values for this property are as follows.

  • 0 - No
  • 1 - Yes

Default value is 1 - Yes

ShowUnits

Boolean

No

Returns/sets whether or not units will be displayed in the FMS History Grid. Possible values for this property are as follows.

  • 0 - No
  • 1 - Yes

Default value is 0 - No

UnitSet

String

No

Returns/sets the unit set used to determine the units of each FMS data item in the FMS History Grid.  Another way to configure this property is to use either the control’s property page or to use the Options page on the FMS History Grid.

Default value is the <Default> unit set

UsePIT

Boolean

No

Returns/sets whether or not the PITDateTime property will be used. Possible values for this property are as follows.

  • 0 - No
  • 1 - Yes

Default value is 0 - No

UseSessionNode

Boolean

No

Returns/sets whether or not the SessionNodeTag property will specify the active Node in the FMS History Grid.  If this property is set to 0 - No, the FMS History Grid will present a Chooser page for selection of the active Node. Possible values for this property are as follows.

  • 0 - No
  • 1 - Yes

Default value is 1 - Yes

Note: The Use Session options property default value is 1 - Yes/True for Data controls (Alarm, Configuration, History Graph, History Grid, Raw Data). The property default value is 0 - No/False for Summary controls (Dashboard, Exceptions) and Admin controls (PPA, Balance, Jobs; not applicable to Close Period).

UseSessionOptions

Boolean

No

Returns/sets whether or not the SessionBeginDate, SessionEndDate, and SessionDateFormat properties will be used in place of the BeginDate, EndDate, and DateFormat properties. Possible values for this property are as follows.

  • 0 - No
  • 1 - Yes

Default value is 1 - Yes

Note: The Use Session options property default value is 1 - Yes/True for Data controls (Alarm, Configuration, History Graph, History Grid, Raw Data). The property default value is 0 - No/False for Summary controls (Dashboard, Exceptions) and Admin controls (PPA, Balance, Jobs; not applicable to Close Period).

Back to top

Let us know how we can improve this topic.

CygNet at weatherford.com

© 2020 Weatherford. All rights reserved.